eKYC Flow Error Codes
Error codes returned from the FPT AI eKYC system can be classified into three main categories: general errors, OCR/NFC errors, and face verification errors:
- Common Errors: These errors arise from improper usage of APIs within the eKYC flow (such as submitting incomplete/incorrect information, exceeding quotas, etc.) or other unspecified issues preventing the request from reaching the eKYC system's processing engine.
In instances where the request successfully reaches the system's processing engine, the returned errors pertain to OCR/NFC processes and face verification:
-
OCR/NFC Errors: Errors identified during the system's examination of document images or data retrieved from the document's NFC chip. These errors are grouped as follows:
-
Face Verification Errors: Errors detected during the system's liveness detection and face matching procedures.
1. Common Errors
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 500 | -1 | There is something wrong. Please try again. | Có lỗi xảy ra. Vui lòng thử lại. | An unknown error occurred during the request processing. |
| 200 | 400 | api-key must be provided | Missing or incorrect API key | |
| 200 | 400 | document-type header must be provided | Missing document type information. Allowed values include "idr" / "dlr" / "passport" | |
| 200 | 400 | document-type value is invalid | Document type information provided but not among allowed values. Allowed values include "idr" / "dlr" / "passport" | |
| 401 | Invalid token | Invalid token | ||
| 403 | 403 | Session expired | eKYC session expired | |
| 200 | 400 | uuid must be provided | Missing session ID information | |
| 200 | 400 | country code value is invalid | Invalid country code information. Allowed value is "vi" | |
| 200 | E101 | Front picture must be taken first | Sai thứ tự chụp ảnh. Vui lòng chụp mặt trước rồi đến mặt sau | Front side of the document must be sent first |
| 200 | E102 | Document type is not supported | Loại giấy tờ không được hỗ trợ | Invalid document type. Allowed values include "idr" / "dlr" / "passport" |
| 200 | E103 | Please capture your rear document | Vui lòng chụp mặt sau giấy tờ | Once the front side has been sent in the session, the front side cannot be sent again |
| 200 | E104 | Please ensure that you request the correct number of files | Vui lòng upload số lượng file đúng yêu cầu | Only the required number of files can be uploaded (1 or 2 files per request) |
| 200 | E105 | Your age is not within the permitted range | Tuổi của bạn không nằm trong phạm vi cho phép | eKYC can only be performed if the user is within the eligible age range |
| 403 | -1 | Session expired | Phiên làm việc đã hết hạn | (Session error) Session has expired |
| 403 | 0 | Invalid hash | Mã băm không hợp lệ | (Session error) Submitted hash code is invalid |
| 403 | 1 | Please capure your document first | Hãy thực hiện bước chụp ảnh giấy tờ trước | (Session error) The previous step of capturing the document image has not been performed |
| 403 | 2 | Retry limit exceeded | Quá số lần thử cho phép | (Session error) Exceeded the allowed number of attempts in the session |
| 403 | 3 | Session is not complete | Phiên làm việc chưa hoàn thành | (Session error) Session is not complete |
2. OCR/NFC Errors
2.1. OCR input file errors
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | 1 | Invalid Parameters or Values! | Giá trị tham số không hợp lệ | Incorrect request information |
| 200 | 3 | Unable to find the selected document in the image | Không tìm thấy tài liệu đã chọn trong ảnh | Valid document not found in the image (either no document of the correct type or the document quality is too poor) |
| 200 | 7 | Invalid image file | File ảnh không đúng định dạng | Uploaded image file is corrupted |
2.2. OCR image quality errors
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | QC00 | Unable to find the selected document in the image | Không tìm thấy tài liệu đã chọn trong ảnh | Valid document not found in the image (either no document of the correct type or the document quality is too poor) |
| 200 | QC01 | Image resolution is too low | Ảnh có độ phân giải quá thấp | Image resolution is too low. Minimum is 640x480. |
| 200 | QC02 | Image has bright spot(s) | Ảnh bị bóng sáng | Document in the image has glare. |
| 200 | QC03 | Image is blurry | Ảnh bị mờ | Image is blurry. |
| 200 | QC04 | Image has bad luminance | Ảnh bị quá sáng hoặc quá tối | Image is too bright or too dark. |
| 200 | QC05 | The image's document size is too small compared to the image | Ảnh bị kích thước tài liệu quá nhỏ so với ảnh | The document's area in the image is too small compared to the total image area. |
2.3. OCR fraud detection errors
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | FC01 | Document is black-and-white photocopy | Giấy tờ là bản photocopy đen trắng | Document is a black-and-white photocopy |
| 200 | FC02 | Document has been re-captured from LCD screen | Giấy tờ là bản chụp lại từ màn hình LCD | Document is re-captured from an LCD screen |
| 200 | FC03 | Document has been edited or is colored photocopy | Giấy tờ đã bị chỉnh sửa hoặc bản photocopy màu | Document is a color photocopy or has been edited |
| 200 | FC04 | Document has been cornered | Giấy tờ bị cắt góc | Document has been cornered |
| 200 | FC05 | Missing face on front side of document | Thiếu khuôn mặt trên mặt trước của giấy tờ | Face not found on the front side of the document |
| 200 | FC06 | Missing QRcode on front side of document | Thiếu QRcode trên mặt trước của giấy tờ | QR code not found on the front side of the chip-based ID card |
| 200 | FC07 | Missing MRZ on back side of document | Thiếu MRZ trên mặt sau của giấy tờ | MRZ area not found on the back side of the chip-based ID card |
| 200 | FC08 | Missing emblem on front side of document | Thiếu quốc huy trên mặt trước của giấy tờ | Emblem not found on the front side of the ID card/Citizen ID card |
| 200 | FC09 | Missing headline on front side of document | Thiếu tiêu ngữ trên mặt trước của giấy tờ | Headline not found on the front side of the ID card/Citizen ID card |
| 200 | FC10 | Missing title on front side of document | Thiếu tiêu đề trên mặt trước của giấy tờ | Title not found on the front side of the ID card/Citizen ID card |
| 200 | FC11 | Missing fingerprint on back side of document | Thiếu vân tay trên mặt sau của giấy tờ | Fingerprint missing on the back side of the ID card/Citizen ID card |
| 200 | FC12 | Missing stamp on back side of document | Thiếu con dấu trên mặt sau của giấy tờ | Stamp not found on the back side of the ID card/Citizen ID card |
| 200 | FC13 | Missing chip on back side of document | Thiếu chip trên mặt sau của giấy tờ | Chip not found on the back side of the chip-based ID card |
| 200 | FC14 | OCR result is uncertain | Kết quả OCR không chắc chắn | OCR result is uncertain |
| 200 | FC15 | ID is uncertain | Kết quả OCR của trường ID không chắc chắn | OCR result for the ID field is uncertain |
| 200 | FC16 | Front side and back side are not from the same background | Mặt trước và mặt sau có nền không giống nhau | The background of the front and back side images are unusually different |
| 200 | FC17 | Missing barcode on back side of document | Thiếu mã vạch trên mặt sau của giấy tờ | Barcode area not found on the back side of the non-chip citizen ID card |
| 200 | FC18 | Missing Anti-counterfeiting stamps on back side of document | Thiếu tem chống hàng giả trên mặt sau của giấy tờ | Anti-counterfeiting stamp not found on the back side of the non-chip citizen ID card |
| 200 | FC19 | Document has been watermark | Giấy tờ bị đóng dấu mờ | Document has been watermarked |
| 200 | FC20 | Document has been perforated | Giấy tờ bị đục lỗ | Passport shows signs of perforation in the MRZ area |
2.4. OCR post-check errors
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | E-1 | Cannot do postcheck | Không thể thực hiện postcheck | An error occurred during the post-check process |
| 200 | E01 | There is a blank field | Có một hoặc nhiều trường bị trống | There is a blank field in the OCR result |
| 200 | E02 | ID format is not correct | Cấu trúc ID sai | The format of the ID number is incorrect |
| 200 | E03 | DoB format is not correct | Cấu trúc ngày sinh sai | The format of the date of birth is incorrect |
| 200 | E04 | DoB is later than today | Ngày sinh không thể sau ngày hôm nay | The date of birth in the OCR result cannot be later than today |
| 200 | E05 | Current age cannot be smaller than 14 | Tuổi hiện tại không thể dưới 14 | Current age under 14 is invalid |
| 200 | E06 | Nationality is not correct | Quốc tịch không đúng | Nationality must be Vietnam |
| 200 | E07 | Year in DoB does not match with ID number | Năm sinh không khớp với số ID | Year of birth does not match the ID number |
| 200 | E08 | Gender code does not match | Mã giới tính không khớp với số ID | Gender code in the ID number does not match |
| 200 | E09 | DoE format is not correct | Cấu trúc ngày hết hạn không đúng | The format of the expiry date is incorrect |
| 200 | E10 | ID card has been expired | Giấy tờ hết hạn | Document has expired |
| 200 | E11 | DoE cannot be KHÔNG THỜI HẠN | Ngày hết hạn không thể là không thời hạn | Expiry date cannot be "KHÔNG THỜI HẠN" (No Expiry) for the submitted document |
| 200 | E12 | DoI format is not correct | Cấu trúc ngày cấp không đúng | The format of the issue date is incorrect |
| 200 | E13 | DoI is later than today | Ngày cấp không thể sau ngày hôm nay | The issue date in the OCR result cannot be later than today |
| 200 | E15 | Please send images of the front and the back side of same type ID (old or new ID) | Hai mặt của giấy tờ không khớp | The two sides of the document are not of the same type (applies to document types other than chip-based Citizen ID) |
| 200 | E16 | There is a blank field in the front side | Có một hoặc nhiều trường bị trống ở mặt trước | There is a blank field in the OCR result of the front side |
| 200 | E17 | Age at issue date cannot be smaller than 14 | Tuổi trên giấy tờ dưới 14 ở thời điểm cấp | Age at the year of issue for ID card/Citizen ID cannot be under 14 |
| 200 | E18 | DoE should be DoI + 15 years | Ngày hết hạn phải là ngày cấp cộng thêm 15 năm | The expiry date of the submitted document must be 15 years from the issue date |
| 200 | E19 | DoE should be birthday at 25 years old | Ngày hết hạn phải là ngày sinh nhật 25 tuổi | The expiry date of the submitted document must be the 25th birthday |
| 200 | E20 | DoE should be birthday at 40 years old | Ngày hết hạn phải là ngày sinh nhật 40 tuổi | The expiry date of the submitted document must be the 40th birthday |
| 200 | E21 | DoE should be birthday at 60 years old | Ngày hết hạn phải là ngày sinh nhật 60 tuổi | The expiry date of the submitted document must be the 60th birthday |
| 200 | E22 | DoE should be KHÔNG THỜI HẠN | Ngày hết hạn phải là không thời hạn | The expiry date of the submitted document must be "KHÔNG THỜI HẠN" (No Expiry) |
| 200 | E30 | Front side and back side are not from the same card | Mặt trước và mặt sau giấy tờ không khớp | The two sides are not from the same document (applies to chip-based Citizen ID) |
| 200 | E31 | Issue location does not match issue date | Nơi cấp không khớp với ngày cấp | Depending on the period the document was issued, the place of issue will change accordingly (applies to non-chip and chip-based Citizen ID) |
| 200 | E32 | Type of document does not match issue date | Loại giấy tờ không khớp với ngày cấp | Applies to chip-based Citizen ID: Chip-based Citizen ID started being issued from 23/01/2021. For Citizen ID 2024: CC started being issued from 01/07/2024. |
| 200 | E33 | DoE should be birthday at 14 years old | Áp dụng cho trường hợp Căn cước mới 2024 có chip: Ngày hết hạn phải là ngày sinh nhật 14 tuổi. | Applies to the new 2024 chip-based Citizen ID: The expiry date must be the 14th birthday. |
| 200 | E36 | Current age cannot smaller than 6 | Tuổi hiện tại không thể dưới 6 | Current age cannot be under 6 |
| 200 | E37 | Age at issue date cannot smaller than 6 | Tuổi trên giấy tờ dưới 6 ở thời điểm cấp đối với Căn cước 2024 | Age on the document is under 6 at the time of issue for Citizen ID 2024 |
| 200 | E110 | Wrong side-type of document | Sai mặt giấy tờ | Incorrect document side submitted. Example: side-type information is "front" but the back side image was sent |
| 200 | QR01 | QR code does not match OCR result | QR code không khớp với kết quả OCR | At least one information field in the QR code result does not match the OCR result |
| 200 | QR02 | QR code format is not correct | QR code không đúng định dạng | QR code is invalid for the document type or an error occurred during QR code processing |
| 200 | MRZ01 | MRZ format error | Lỗi định dạng MRZ | MRZ does not have 3 lines or line length is incorrect |
| 200 | MRZ02 | MRZ contains invalid characters | MRZ chứa ký tự không hợp lệ | Contains characters not in allowed set A-Z, 0-9 and < |
| 200 | MRZ03 | Info fields in MRZ mismatch with OCR | Trường thông tin trong MRZ không khớp với dữ liệu OCR | Information fields in MRZ do not match OCR data (id_number, dob, doe, gender, nationality, name) |
| 200 | MRZ04 | Info fields in MRZ have invalid formats | Định dạng trường thông tin trong MRZ không hợp lệ | Invalid format for fields in MRZ (dob, doe, name) |
| 200 | MRZ05 | Info fields in MRZ have invalid check digits | Mã kiểm tra của các trường thông tin trong MRZ không đúng | Invalid check digits |
2.5. NFC data verification errors
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | 0 | Check chip thành công | Check chip successfully | Checking request of NFC data in chip successful |
| 200 | CC01 | Data is not integrity | Dữ liệu trong chip không toàn vẹn | Data in the chip is not intact |
| 200 | CC02 | Data is clone | Dữ liệu bị sao chép | Data is cloned |
| 200 | CC03 | C06 authentication failed | Xác thực BCA thất bại | RAR authentication failed |
3. Face Verification Errors
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | 200 | No error | ||
| 200 | 301 | Face in video is spoof | Kiểm tra thực thể sống không thành công | Liveness check failed |
| 200 | 302 | Video seems like deepfake | Video có dấu hiệu chỉnh sửa | Video shows signs of editing |
| 200 | 303 | Face is not matching with document | Khuôn mặt không khớp với giấy tờ | Face in video/selfie does not match the face on the document |
| 200 | 406 | Face quality is not good enough (covered, too dark/bright..) | Chất lượng video không đạt (khuôn mặt bị che, ngược sáng,..) | Face image quality is not good (covered, too dark or too bright, ...) |
| 200 | 407 | No face/More than 1 face in document | Không tìm thấy hoặc có nhiều hơn 1 khuôn mặt trong giấy tờ | No face found or more than one face found in the document |
| 200 | 408 | More than 1 face in the video | Xuất hiện nhiều hơn 1 khuôn mặt trong khung hình | More than one face found in the video/selfie |
| 200 | 409 | No video uploaded/Wrong extension/Video is too short/Invalid input | Video quá ngắn | No video uploaded / Incorrect video format / Video is too short / Invalid video input |
| 200 | 410 | No face/Lost face in the video | Mất dấu khuôn mặt trong quá trình quay video | No face found or face lost during video recording |
| 200 | 411 | The face is too small | Khuôn mặt quá nhỏ, vui lòng đưa lại gần màn hình hơn | Face in the video is too small |
| 200 | 412 | The face is too blurry | Video quá mờ | Face in the video is blurry |
| 200 | 413 | Video is still image | Video trông giống ảnh | Video recorded a static image |
| 200 | 422 | No frontal face in video | Không xuất hiện khuôn mặt thẳng trong khung hình | No frame with a frontal face found in the video |
| 200 | 423 | Face is out of frame during video | Khuôn mặt bị ra khỏi khung hình | Face went out of frame |
| 200 | 424 | The requested face pose is not valid | Quay trái phải không hợp lệ | Invalid left/right turning process |
| 200 | W100 | Please do not close your eyes | Vui lòng không nhắm mắt | Detected closing both eyes |
| 200 | W103 | Please do not close your eyes | Vui lòng không nhắm mắt | Detected closing left eye |
| 200 | W104 | Please do not close your eyes | Vui lòng không nhắm mắt | Detected closing right eye |
| 200 | W105 | Please do not close your eyes | Vui lòng không nhắm mắt | Detected closing right eye |